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)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // 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, צריך להשאיר את השדה הזה ריק.
containsSyntheticMedia

boolean

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

צריך להגדיר את זה רק למודעות שנוצרו על ידי מפרסמים מאומתים של מודעות בנושא בחירות. האפשרות הזו רלוונטית רק למודעות YouTube.
parentCreativeId

string (int64 format)

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

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

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

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

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

string

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

string

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

string

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

בגרסה 4 ובגרסאות קודמות, השדה הזה מייצג את כתובת ה-URL למעקב שהמשתמש ציין באופן ידני. אפשר למצוא את זה ב-userSpecifiedTrackingUrl בגרסה 5.
userSpecifiedTrackingUrl

string

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

string

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

צריך להגדיר את השדה אם השדה actionHeadline מוגדר.
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,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
שדות
displayUrl

string

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

string

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

string

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

בגרסה 4 ובגרסאות קודמות, השדה הזה מייצג את כתובת ה-URL למעקב שהמשתמש ציין באופן ידני. אפשר למצוא את זה ב-userSpecifiedTrackingUrl בגרסה 5.
userSpecifiedTrackingUrl

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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
שדות
finalUrl

string

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

string

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

בגרסה 4 ובגרסאות קודמות, השדה הזה מייצג את כתובת ה-URL למעקב שהמשתמש ציין באופן ידני. אפשר למצוא את זה ב-userSpecifiedTrackingUrl בגרסה 5.
userSpecifiedTrackingUrl

string

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

string

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

צריך להגדיר את השדה הזה אם השדה headlines מוגדר.
headlines[]

string

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

string

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

חובה להגדיר את השדה הזה, אלא אם הערך של lineItemType בפריט ההורה הוא LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. במקרה כזה, אי אפשר להגדיר את השדה הזה.
descriptions[]

string

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

חובה להגדיר את השדה הזה, אלא אם הערך של lineItemType בפריט ההורה הוא LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. במקרה כזה, אי אפשר להגדיר את השדה הזה.
displayUrlBreadcrumb1

string

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

string

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

אפשר להגדיר את זה רק אם גם displayUrlBreadcrumb1 מוגדר.
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)

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

string

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

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

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)

חוסר התאמה בין כתובות היעד של המודעות.
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

אכיפה יזומה של מדיניות Trust & Safety (אמון ובטיחות) שנועדה לעמוד בדרישות אזוריות. החקירה הזו נחשבת לחקירה בבעלות 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 של המודעה.
url

string

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

AdUrlType

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

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

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

 מעדכנת מודעה בקבוצת מודעות.