REST Resource: advertisers.adGroupAds

משאב: AdGroupAd

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

ייצוג ב-JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
שדות
name

string

פלט בלבד. שם המשאב של המודעה.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

object (AdPolicy)

פלט בלבד. סטטוס האישור של המודעה בהתאם למדיניות.
entityStatus

enum (EntityStatus)

חובה. סטטוס הישות של המודעה.
adUrls[]

object (AdUrl)

פלט בלבד. רשימה של כתובות URL שבהן נעשה שימוש במודעה.
dcmTrackingInfo

object (DcmTrackingInfo)

אופציונלי. פרטי המודעה למעקב ב-DCM. תקף רק למודעות ליצירת ביקוש.

כדי להסיר את פרטי המודעה למעקב ב-DCM, צריך להשאיר את השדה הזה ריק.
פרטי המודעה. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
displayVideoSourceAd

object (DisplayVideoSourceAd)

פלט בלבד. פרטים של מודעה שמקורה בקריאייטיב ב-Display & Video 360.
mastheadAd

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

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

object (AudioAd)

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

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

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

object (DemandGenVideoAd)

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

object (DemandGenImageAd)

פרטים של מודעת תמונה אחת ליצירת ביקוש.
demandGenProductAd

object (DemandGenProductAd)

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

DisplayVideoSourceAd

המודעה נוצרה מקריאייטיב ב-DV360.

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

string (int64 format)

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

MastheadAd

פרטים על מודעת Masthead.

ייצוג ב-JSON 
{
  "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)
    }
  ]
}
שדות
video

object (YoutubeVideoDetails)

הסרטון ב-YouTube שבו נעשה שימוש במודעה.
headline

string

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

string

תיאור המודעה.
videoAspectRatio

enum (VideoAspectRatio)

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

string (int64 format)

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

string (Duration format)

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

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

string

הטקסט שיופיע בכפתור הקריאה לפעולה.
callToActionFinalUrl

string

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

string

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

boolean

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

object (YoutubeVideoDetails)

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

YoutubeVideoDetails

פרטים של סרטון ב-YouTube.

ייצוג ב-JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
שדות
id

string

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

enum (VideoUnavailableReason)

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

string (int64 format)

חובה. מזהה נכס של סרטון ב-YouTube. זהו adAssetId של משאב AdAsset.

VideoUnavailableReason

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

טיפוסים בני מנייה (enum)
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED לא ידוע או לא צוין.
VIDEO_UNAVAILABLE_REASON_PRIVATE הסרטון פרטי.
VIDEO_UNAVAILABLE_REASON_DELETED הסרטון נמחק.

VideoAspectRatio

יחסי גובה-רוחב אפשריים לסרטון ב-YouTube.

טיפוסים בני מנייה (enum)
VIDEO_ASPECT_RATIO_UNSPECIFIED לא צוין או לא ידוע.
VIDEO_ASPECT_RATIO_WIDESCREEN הסרטון נמתח והחלק העליון והתחתון שלו נחתכים.
VIDEO_ASPECT_RATIO_FIXED_16_9 הסרטון משתמש ביחס גובה-רוחב קבוע של 16:9.

InStreamAd

פרטים של מודעת וידאו In-stream.

ייצוג ב-JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
שדות
commonInStreamAttribute

object (CommonInStreamAttribute)

מאפייני מודעה נפוצים.
customParameters

map (key: string, value: string)

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

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

CommonInStreamAttribute

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

ייצוג ב-JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
שדות
displayUrl

string

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

string

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

string

כתובת ה-URL שנטענת ברקע לצורכי מעקב.
actionButtonLabel

string

הטקסט שיופיע בכפתור הקריאה לפעולה.
actionHeadline

string

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

object (YoutubeVideoDetails)

סרטון ב-YouTube של המודעה.
companionBanner

object (ImageAsset)

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

ImageAsset

מטא-נתונים של נכס תמונות.

ייצוג ב-JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
שדות
mimeType

string

פלט בלבד. סוג MIME של נכס התמונות.
fullSize

object (Dimensions)

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

string (int64 format)

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

string (int64 format)

חובה. המזהה הייחודי של הנכס.

NonSkippableAd

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

ייצוג ב-JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
שדות
commonInStreamAttribute

object (CommonInStreamAttribute)

מאפייני מודעה נפוצים.
customParameters

map (key: string, value: string)

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

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

BumperAd

פרטים על מודעת באמפר.

ייצוג ב-JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
שדות
commonInStreamAttribute

object (CommonInStreamAttribute)

מאפייני מודעה נפוצים.

AudioAd

פרטים על מודעת אודיו.

ייצוג ב-JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
שדות
displayUrl

string

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

string

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

string

כתובת ה-URL שנטענת ברקע לצורכי מעקב.
video

object (YoutubeVideoDetails)

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

VideoDiscoveryAd

פרטים של מודעת וידאו Discovery.

ייצוג ב-JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
שדות
headline

string

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

string

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

string

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

object (YoutubeVideoDetails)

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

enum (Thumbnail)

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

תמונה ממוזערת

אפשרויות לתמונות ממוזערות במודעות וידאו Discovery.

טיפוסים בני מנייה (enum)
THUMBNAIL_UNSPECIFIED לא ידוע או לא צוין.
THUMBNAIL_DEFAULT התמונה הממוזערת שמוגדרת כברירת מחדל יכולה להיווצר באופן אוטומטי או להיות תמונה שהמשתמש העלה.
THUMBNAIL_1 תמונה ממוזערת 1, שנוצרה מהסרטון.
THUMBNAIL_2 תמונה ממוזערת 2, שנוצרה מהסרטון.
THUMBNAIL_3 תמונה ממוזערת 3, שנוצרה מהסרטון.

VideoPerformanceAd

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

ייצוג ב-JSON 
{
  "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)
    }
  ]
}
שדות
finalUrl

string

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

string

כתובת ה-URL שנטענת ברקע לצורכי מעקב.
actionButtonLabels[]

string

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

string

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

string

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

string

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

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

DemandGenVideoAd

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

ייצוג ב-JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
שדות
finalUrl

string

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

string

פלט בלבד. כתובת ה-URL שנטענת ברקע לצורכי מעקב.
userSpecifiedTrackingUrl

string

אופציונלי. כתובת ה-URL למעקב שצוינה ידנית על ידי המשתמש.
callToAction

enum (CallToAction)

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

הערכים הנתמכים הם:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

חובה. רשימת הכותרות שמוצגות במודעה.
longHeadlines[]

string

חובה. רשימת הכותרות הארוכות שמוצגות במודעה.
descriptions[]

string

חובה. רשימת התיאורים שמוצגים במודעה.
displayUrlBreadcrumb1

string

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

string

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

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

אופציונלי. מודעת הבאנר הנלווית שמשמשת את המודעה הזו.
finalMobileUrl

string

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

string

אופציונלי. הסיומת שמוסיפים לכתובות של דפי הנחיתה.
businessName

string

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

ההגדרה הזו נדרשת אלא אם מוגדר ערך ברירת מחדל ברמת המפרסם. אם לא תגדירו ערך, המערכת תשתמש בערך ברירת המחדל.

CallToAction

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

טיפוסים בני מנייה (enum)
CALL_TO_ACTION_UNSPECIFIED לא צוין או לא ידוע.
AUTOMATED אוטומטיות.
LEARN_MORE למידע נוסף
GET_QUOTE לקבלת הצעת מחיר
APPLY_NOW להגשת בקשה
SIGN_UP הרשמה.
CONTACT_US אפשר לפנות אלינו.
SUBSCRIBE הירשם.
DOWNLOAD הורדה.
BOOK_NOW כדאי להזמין עכשיו.
SHOP_NOW לקנייה
BUY_NOW קני עכשיו.
DONATE_NOW רוצה לתרום?
ORDER_NOW להזמנה
PLAY_NOW למשחק
SEE_MORE מידע נוסף
START_NOW התחילו עכשיו.
VISIT_SITE כניסה לאתר.
WATCH_NOW צפה עכשיו.

DemandGenImageAd

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

ייצוג ב-JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
שדות
finalUrl

string

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

string

פלט בלבד. כתובת ה-URL שנטענת ברקע לצורכי מעקב.
userSpecifiedTrackingUrl

string

אופציונלי. כתובת ה-URL למעקב שצוינה ידנית על ידי המשתמש.
callToAction

string

חובה. לחצן הקריאה לפעולה שמוצג במודעה.
headlines[]

string

חובה. רשימת הכותרות שמוצגות במודעה.
descriptions[]

string

חובה. רשימת התיאורים שמוצגים במודעה.
customParameters

map (key: string, value: string)

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

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

string

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

string

אופציונלי. הסיומת שמוסיפים לכתובות של דפי הנחיתה.
businessName

string

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

ההגדרה הזו נדרשת אלא אם מוגדר ערך ברירת מחדל ברמת המפרסם. אם לא תגדירו ערך, המערכת תשתמש בערך ברירת המחדל.
marketingImages[]

object (ImageAsset)

רשימת התמונות השיווקיות שמוצגות במודעה.
squareMarketingImages[]

object (ImageAsset)

רשימת התמונות השיווקיות הריבועיות שמוצגות במודעה.
portraitMarketingImages[]

object (ImageAsset)

רשימת התמונות השיווקיות בפורמט לאורך שמוצגות במודעה.
logoImages[]

object (ImageAsset)

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

ההגדרה הזו נדרשת אלא אם מוגדר ערך ברירת מחדל ברמת המפרסם. אם לא תגדירו ערך, המערכת תשתמש בערך ברירת המחדל.

DemandGenCarouselAd

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

ייצוג ב-JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
שדות
finalUrl

string

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

string

חובה. הכותרת של המודעה.
description

string

חובה. תיאור המודעה.
cards[]

object (CarouselCard)

חובה. רשימת הכרטיסים שמוצגים במודעה.
finalUrlSuffix

string

אופציונלי. הסיומת שמוסיפים לכתובות של דפי הנחיתה.
trackingUrl

string

פלט בלבד. כתובת ה-URL שנטענת ברקע לצורכי מעקב.
userSpecifiedTrackingUrl

string

אופציונלי. כתובת ה-URL למעקב שצוינה על ידי המשתמש באופן ידני.
businessName

string

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

ההגדרה הזו נדרשת אלא אם מוגדר ערך ברירת מחדל ברמת המפרסם. אם לא תגדירו ערך, המערכת תשתמש בערך ברירת המחדל.
customParameters

map (key: string, value: string)

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

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

CarouselCard

פרטים על כרטיס קרוסלה ליצירת ביקוש.

ייצוג ב-JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
שדות
finalUrl

string

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

string

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

string

חובה. הכותרת של הכרטיס.
callToAction

string

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

האורך המקסימלי הוא 10 תווים.
marketingImage

object (ImageAsset)

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

object (ImageAsset)

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

object (ImageAsset)

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

DemandGenProductAd

פרטים על מודעת מוצר ליצירת ביקוש.

ייצוג ב-JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
שדות
finalUrl

string

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

string

חובה. הכותרת של המודעה.
description

string

חובה. תיאור המודעה.
finalUrlSuffix

string

אופציונלי. הסיומת שמוסיפים לכתובות של דפי הנחיתה.
callToAction

enum (CallToAction)

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

הערכים הנתמכים הם:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

פלט בלבד. כתובת ה-URL שנטענת ברקע לצורכי מעקב.
userSpecifiedTrackingUrl

string

אופציונלי. כתובת ה-URL למעקב שצוינה על ידי המשתמש באופן ידני.
businessName

string

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

ההגדרה הזו נדרשת אלא אם מוגדר ערך ברירת מחדל ברמת המפרסם. אם לא תגדירו ערך, המערכת תשתמש בערך ברירת המחדל.
customParameters

map (key: string, value: string)

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

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

string

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

string

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

AdPolicy

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

ייצוג ב-JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
שדות
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

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

enum (AdPolicyReviewStatus)

סטטוס בדיקת העמידה במדיניות של מודעה, שמציין באיזה שלב בתהליך הבדיקה המודעה נמצאת כרגע.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

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

AdPolicyApprovalStatus

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

טיפוסים בני מנייה (enum)
AD_POLICY_APPROVAL_STATUS_UNKNOWN לא ידוע או לא צוין.
DISAPPROVED המודעות לא יוצגו.
APPROVED_LIMITED יוצגו מודעות בכפוף להגבלות.
APPROVED יוצגו ללא הגבלות.
AREA_OF_INTEREST_ONLY לא יוצגו במדינות המטורגטות, אבל יכול להיות שיוצגו למשתמשים שמחפשים מידע על המדינות המטורגטות.

AdPolicyReviewStatus

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

טיפוסים בני מנייה (enum)
AD_POLICY_REVIEW_STATUS_UNKNOWN לא ידוע או לא צוין.
REVIEW_IN_PROGRESS בבדיקה כרגע.
REVIEWED הבדיקה הראשונית הושלמה. יכול להיות שביקורות אחרות עדיין בבדיקה.
UNDER_APPEAL הפריט נשלח מחדש לאישור או שהוגש ערעור על החלטה לגבי הפרת מדיניות.
ELIGIBLE_MAY_SERVE הקמפיין נחשב כשיר להצגה ויכול להיות שהוא מוצג. יכול להיות שעדיין תתבצע בדיקה נוספת.

AdPolicyTopicEntry

רשומה שמתארת איך זוהתה מודעה כקשורה למדיניות בנושא מודעות.

ייצוג ב-JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
שדות
policyTopic

string

הנושא במדיניות.

לדוגמה, 'סימני מסחר', 'אלכוהול' וכו'.
policyLabel

string

טקסט התווית המותאם לשפה המקומית של המדיניות.

לדוגמה, 'סימני מסחר בטקסט', 'מכיל אלכוהול' וכו'.
policyTopicDescription

string

סיכום קצר של נושא המדיניות.
policyTopicType

enum (AdPolicyTopicEntryType)

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

enum (AdPolicyDecisionType)

המקור של ההחלטה לגבי הפרת מדיניות.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

אמצעי אכיפת המדיניות שנעשה בהם שימוש בבדיקת המדיניות.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

הראיות ששימשו לקבלת ההחלטה לגבי הפרת מדיניות.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

ההגבלות על הצגת המודעות שרלוונטיות להחלטה לגבי הפרת מדיניות.
appealInfo

object (AdPolicyTopicAppealInfo)

מידע על הגשת ערעור על ההחלטה לגבי הפרת מדיניות.

AdPolicyTopicEntryType

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

טיפוסים בני מנייה (enum)
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN לא ידוע או לא צוין.
PROHIBITED המשאב לא יוצג.
FULLY_LIMITED המשאב לא יוצג בכל המדינות המטורגטות.
LIMITED אי אפשר להציג את המשאב במדינות מסוימות.
DESCRIPTIVE אפשר להציג את המשאב.
BROADENING המשאב יכול לשרת, ויכול להיות שהוא ישרת מעבר לכיסוי הרגיל.
AREA_OF_INTEREST_ONLY הגישה למשאב מוגבלת בכל המדינות המטורגטות, אבל יכול להיות שהוא יוצג למשתמשים שמחפשים מידע על המדינות המטורגטות.

AdPolicyDecisionType

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

טיפוסים בני מנייה (enum)
AD_POLICY_DECISION_TYPE_UNKNOWN לא ידוע או לא צוין.
PURSUANT_TO_NOTICE ההחלטה התקבלה בעקבות הודעה משפטית, צו בית משפט, תלונה מבעלי תוכן של סימן מסחרי וכו'.
GOOGLE_INVESTIGATION ההחלטה התקבלה בעקבות חקירה שבוצעה על ידי Google.

AdPolicyEnforcementMeans

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

טיפוסים בני מנייה (enum)
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN לא ידוע או לא צוין.
AUTOMATED תהליך האכיפה היה אוטומטי לחלוטין.
HUMAN_REVIEW אדם היה מעורב באופן חלקי או מלא בתהליך האכיפה של ההחלטה.

AdPolicyTopicEvidence

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

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
שדות
ההוכחה להחלטה לגבי הפרת מדיניות. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
textList

object (TextList)

רשימת ההוכחות שנמצאו בטקסט של המודעה.
websiteList

object (WebsiteList)

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

integer

קוד ה-HTTP שמוחזר כשכתובת ה-URL הסופית נסרקה.
languageCode

string

השפה שבה זוהה שהמודעה כתובה.

בשדה הזה משתמשים בתגי שפה של IETF, כמו en-US.
destinationTextList

object (DestinationTextList)

הטקסט ביעד של המודעה שגורם להפרת מדיניות.
destinationMismatch

object (DestinationMismatch)

חוסר התאמה בין כתובות ה-URL של יעד המודעה.
destinationNotWorking

object (DestinationNotWorking)

מידע על שגיאות HTTP או DNS שקשורות ליעד המודעה.
trademark

object (Trademark)

מונחים שקשורים לסימנים מסחריים שגרמו להפרת מדיניות.
legalRemoval

object (LegalRemoval)

אכיפת תקנות שקשורות לדינים ולחוקים, שגרמה להפרת מדיניות.
counterfeit

object (Counterfeit)

אכיפה בנושא מוצרים מזויפים שגרמה להפרת מדיניות.
regionalRequirements

object (RegionalRequirements)

אכיפה יזומה של צוות T&S שגרמה להפרת מדיניות.
סוף השדות הבלעדיים.

TextList

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

ייצוג ב-JSON 
{
  "texts": [
    string
  ]
}
שדות
texts[]

string

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

WebsiteList

רשימת האתרים שהפרו את המדיניות.

ייצוג ב-JSON 
{
  "websites": [
    string
  ]
}
שדות
websites[]

string

אתרים שגרמו לממצא בנושא מדיניות.

DestinationTextList

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

ייצוג ב-JSON 
{
  "destinationTexts": [
    string
  ]
}
שדות
destinationTexts[]

string

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

DestinationMismatch

פרטים על חוסר התאמה בין סוגי כתובות היעד.

ייצוג ב-JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
שדות
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

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

דוגמה 1: [DISPLAY_URL, FINAL_URL] פירושה שכתובת ה-URL לתצוגה של המודעה לא זהה לכתובת ה-URL הסופית של המודעה.

דוגמה 2: [FINAL_URL] פירושו שכתובת ה-URL הסופית של המודעה לא תאמה לכתובת ה-URL שנסרקה, וגם זה נחשב לחוסר התאמה בין מודעות ליעדיהן.

AdPolicyTopicEvidenceDestinationMismatchUrlType

סוגי כתובות URL אפשריים.

טיפוסים בני מנייה (enum)
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN לא צוין או לא ידוע.
DISPLAY_URL כתובת ה-URL לתצוגה.
FINAL_URL כתובת ה-URL הסופית.
FINAL_MOBILE_URL כתובת הדף הסופית בנייד.
TRACKING_URL כתובת ה-URL למעקב.
MOBILE_TRACKING_URL כתובת ה-URL למעקב בנייד.

DestinationNotWorking

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

ייצוג ב-JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
שדות
expandedUri

string

כתובת ה-URL המלאה שלא עבדה.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

המכשיר שבו הכניסה לכתובת ה-URL גרמה לשגיאה.
lastCheckedTime

string (Timestamp format)

הפעם האחרונה שבה השגיאה נראתה כשעוברים לכתובת ה-URL.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
שגיאת ה-HTTP או ה-DNS. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

סוג שגיאת ה-DNS.
httpErrorCode

string (int64 format)

קוד שגיאת ה-HTTP.
סוף השדות הבלעדיים.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

סוגים אפשריים של שגיאות DNS.

טיפוסים בני מנייה (enum)
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN לא צוין או לא ידוע.
HOSTNAME_NOT_FOUND שם המארח לא נמצא ב-DNS כשמנסים לאחזר את דף הנחיתה.
GOOGLE_CRAWLER_DNS_ISSUE ‫Google לא הצליחה לסרוק את דף הנחיתה במהלך התקשורת עם DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

מכשירים אפשריים שבהם הוצגה שגיאה כשנכנסו לכתובת ה-URL.

טיפוסים בני מנייה (enum)
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN לא צוין או לא ידוע.
DESKTOP מחשב.
ANDROID מכשיר Android.
IOS מכשיר iOS.

סימן מסחרי

מונחים שקשורים לסימנים מסחריים שגרמו להפרת מדיניות.

ייצוג ב-JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
שדות
owner

string

הבעלים של התוכן שמוגן בסימן המסחרי.
term

string

המונח של הסימן המסחרי.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

מדינות שבהן הפרת המדיניות רלוונטית.

AdPolicyCriterionRestriction

מייצג הגבלה על מדינה.

ייצוג ב-JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
שדות
countryCriterionId

string (int64 format)

מזהה הקריטריון של המדינה.
countryLabel

string

שם המדינה בשפה המקומית. יכול להיות ריק.

LegalRemoval

אכיפת תקנות שקשורות לדינים, בהתאם ל-DMCA או לתקנות משפטיות מקומיות.

ייצוג ב-JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
שדות
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

סוג התלונה שגורמת להסרת תוכן בעקבות בקשה משפטית.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

המדינות שבהן הגישה הוגבלה בגלל הסרת תוכן בעקבות בקשה משפטית.
restrictedUris[]

string

כתובות ה-URL שהגישה אליהן הוגבלה בגלל הסרת תוכן בעקבות בקשה משפטית.
פרטים על סוג הסרת תוכן בעקבות בקשה משפטית. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
dmca

object (Dmca)

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

DMCA

פרטים של תלונה לפי חוק DMCA.

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

string

הישות שהגישה את התלונה בנושא משפטי.

LocalLegal

פרטים על תקנות משפטיות מקומיות.

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

string

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

AdPolicyTopicEvidenceLegalRemovalComplaintType

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

טיפוסים בני מנייה (enum)
COPYRIGHT

זכויות יוצרים.

ההגדרה רלוונטית רק ל-DMCA.
COURT_ORDER

צו בית משפט.

ההגדרה חלה רק על חוקים מקומיים.

זיוף

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

ייצוג ב-JSON 
{
  "owners": [
    string
  ]
}
שדות
owners[]

string

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

RegionalRequirements

אכיפה יזומה של מדיניות בנושא אמון ובטיחות (T&S) שמיועדת לעמוד בדרישות אזוריות. הפעולה הזו נחשבת לחקירה בבעלות Google ולא להודעה על תקנה, כי מדובר באכיפה יזומה של התנאים וההגבלות.

ייצוג ב-JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
שדות
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

רשימת הדרישות האזוריות.

RegionalRequirementsEntry

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

ייצוג ב-JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
שדות
legalPolicy

string

המדיניות המשפטית שהופרה.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

המדינות שבהן יש הגבלות בגלל המדיניות המשפטית.

AdPolicyTopicConstraint

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

ייצוג ב-JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
שדות
הגבלת הפרסום. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

מגבלה על מפיץ.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

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

object (AdPolicyCountryConstraintList)

מדינות שבהן הדומיין של המשאב לא מכוסה על ידי האישורים שמשויכים אליו.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

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

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

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

AdPolicyCountryConstraintList

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

ייצוג ב-JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
שדות
countries[]

object (AdPolicyCriterionRestriction)

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

AdPolicyResellerConstraint

בסוג הזה אין שדות.

נושא המדיניות הוגבל בגלל שהאתר נפסל למטרות מכירה חוזרת.

AdPolicyGlobalCertificateMissingConstraint

בסוג הזה אין שדות.

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

AdPolicyGlobalCertificateDomainMismatchConstraint

בסוג הזה אין שדות.

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

AdPolicyTopicAppealInfo

מידע על הגשת ערעור על החלטה לגבי הפרת מדיניות.

ייצוג ב-JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
שדות
appealType

enum (AdPolicyAppealType)

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

AdPolicyAppealType

סוגי ערעורים אפשריים.

טיפוסים בני מנייה (enum)
AD_POLICY_APPEAL_TYPE_UNKNOWN לא ידוע או לא צוין.
SELF_SERVICE_APPEAL אפשר לערער על ההחלטה באמצעות הכלי לערעורים בשירות עצמי.
APPEAL_FORM אפשר לערער על ההחלטה באמצעות טופס ערעור.

AdUrl

כתובות URL נוספות שקשורות למודעה, כולל משואות.

ייצוג ב-JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
שדות
type

enum (AdUrlType)

סוג כתובת האתר של המודעה.
url

string

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

AdUrlType

סוגים אפשריים של כתובות URL של מודעות.

טיפוסים בני מנייה (enum)
AD_URL_TYPE_UNSPECIFIED לא ידוע או לא צוין.
AD_URL_TYPE_BEACON_IMPRESSION פיקסל מעקב בגודל 1x1 ששולח פינג כשמתקבלת חשיפה של קריאייטיב.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION חיישן חשיפה ב-DCM שאפשר להרחיב. בזמן ההצגה, הוא מורחב לכמה חיישני Beacon.
AD_URL_TYPE_BEACON_CLICK כתובת URL למעקב שיישלח אליה פינג כשהאירוע מסוג קליק מופעל.
AD_URL_TYPE_BEACON_SKIP כתובת URL למעקב שיופעל פינג שלה כשהאירוע skip (דילוג) מופעל.

DcmTrackingInfo

פרטים על המעקב ב-DCM.

ייצוג ב-JSON 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
שדות
placementId

string (int64 format)

חובה. מזהה מיקום המודעה ב-DCM.
trackingAdId

string (int64 format)

חובה. מזהה המודעה למעקב ב-DCM.
creativeId

string (int64 format)

חובה. מזהה הקריאייטיב ב-DCM.

Methods

create

 יוצרת מודעה בקבוצת מודעות.

delete

 מחיקת מודעה בקבוצת מודעות.

get

 מאחזר את המודעה בקבוצת המודעות.

list

 רשימה של מודעות בקבוצת מודעות.

patch

 עדכון של מודעה בקבוצת מודעות.