REST Resource: customers.ads

FinalAppUrl

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

ייצוג JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
שדות
osType

enum (AppUrlOperatingSystemType)

מערכת ההפעלה שכתובת ה-URL הזו מטרגטת. חובה.
url

string

כתובת ה-URL של קישור העומק לאפליקציה. קישורי עומק מציינים מיקום באפליקציה התואם לתוכן שברצונך להציג, והם צריכים להיות בפורמט {scheme}://{host_path}. הסכמה מזהה את האפליקציה שיש לפתוח. עבור האפליקציה, אפשר להשתמש בסכמה מותאמת אישית שמתחילה בשם האפליקציה. המארח והנתיב מציינים את המיקום הייחודי באפליקציה שבו נמצא התוכן שלכם. דוגמה: "exampleapp://productid_1234". חובה.

AppUrlOperatingSystemType

מערכת הפעלה

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
IOS מערכת ההפעלה של Apple IOS.
ANDROID מערכת ההפעלה Android.

CustomParameter

מיפוי שיכול לשמש תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, finalUrls או mobile_final_urls.

ייצוג JSON 
{
  "key": string,
  "value": string
}
שדות
key

string

המפתח שתואם לשם של תג הפרמטר.
value

string

הערך להחלפה.

AdType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
TEXT_AD המודעה היא מודעת טקסט.
EXPANDED_TEXT_AD המודעה היא מודעת טקסט מורחבת.
EXPANDED_DYNAMIC_SEARCH_AD המודעה היא מודעה דינמית מורחבת לרשת החיפוש.
HOTEL_AD מדובר במודעה להזמנת חדרים.
SHOPPING_SMART_AD המודעה היא מודעת שופינג חכמה.
SHOPPING_PRODUCT_AD המודעה היא מודעת שופינג רגילה.
VIDEO_AD המודעה היא מודעת וידאו.
IMAGE_AD מודעה זו היא מודעת תמונה.
RESPONSIVE_SEARCH_AD המודעה היא מודעה רספונסיבית לרשת החיפוש.
LEGACY_RESPONSIVE_DISPLAY_AD המודעה היא מודעה רספונסיבית מדור קודם לרשת המדיה.
APP_AD מדובר במודעה לקידום אפליקציה.
LEGACY_APP_INSTALL_AD המודעה היא מודעה מדור קודם להתקנת אפליקציה.
RESPONSIVE_DISPLAY_AD המודעה היא מודעה רספונסיבית לרשת המדיה (RDA).
LOCAL_AD מדובר במודעה מקומית.
HTML5_UPLOAD_AD המודעה היא מודעה להעלאה לרשת המדיה עם סוג המוצר HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD המודעה היא מודעה להעלאה לרשת המדיה שכוללת את אחד מסוגי המוצרים DYNAMIC_HTML5_* .
APP_ENGAGEMENT_AD המודעה היא מודעה לעידוד השימוש באפליקציה.
SHOPPING_COMPARISON_LISTING_AD המודעה היא מודעת השוואת מחירים.
VIDEO_BUMPER_AD מודעת וידאו מסוג באמפר.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD מודעת וידאו In-stream שלא ניתן לדלג עליה.
VIDEO_OUTSTREAM_AD מודעת וידאו Outstream.
VIDEO_TRUEVIEW_IN_STREAM_AD מודעת וידאו TrueView In-stream.
VIDEO_RESPONSIVE_AD מודעת וידאו רספונסיבית.
SMART_CAMPAIGN_AD מודעה בקמפיין חכם.
CALL_AD מודעה לשיחות.
APP_PRE_REGISTRATION_AD מודעה אוניברסלית לרישום מראש באפליקציות.
IN_FEED_VIDEO_AD מודעת וידאו בגוף הפיד.
DISCOVERY_MULTI_ASSET_AD מודעת Discovery עם כמה נכסים.
TRAVEL_AD מודעה לנסיעות.
DISCOVERY_VIDEO_RESPONSIVE_AD מודעה רספונסיבית של וידאו Discovery.

מכשיר

פירוט של מכשירי Google Ads שזמינים לטירגוט.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
MOBILE ניידים עם דפדפני אינטרנט מלאים.
TABLET טאבלטים עם דפדפנים מלאים.
DESKTOP מחשבים.
CONNECTED_TV טלוויזיות חכמות וקונסולות משחקים.
OTHER סוגי מכשירים אחרים.

UrlCollection

אוסף של כתובות URL שתויגו במזהה ייחודי.

ייצוג JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
שדות
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות.
finalMobileUrls[]

string

רשימה של כתובות URL סופיות לנייד.
urlCollectionId

string

מזהה ייחודי למופע הזה של UrlCollection.
trackingUrlTemplate

string

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

SystemManagedResourceSource

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
AD_VARIATIONS מודעת ניסוי שנוצרה באמצעות וריאציות של מודעה.

TextAdInfo

מודעת טקסט.

ייצוג JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
שדות
headline

string

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

string

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

string

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

ExpandedTextAdInfo

מודעת טקסט מורחבת.

ייצוג JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
שדות
headlinePart1

string

החלק הראשון של כותרת המודעה.
headlinePart2

string

החלק השני של כותרת המודעה.
headlinePart3

string

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

string

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

string

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

string

הטקסט שיכול להופיע לצד כתובת ה-URL לתצוגה של המודעה.
path2

string

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

CallAdInfo

מודעה לשיחות.

ייצוג JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
שדות
countryCode

string

קוד המדינה שמוצג במודעה.
phoneNumber

string

מספר הטלפון שמוצג במודעה.
businessName

string

שם העסק שמוצג במודעה.
headline1

string

הכותרת הראשונה במודעה.
headline2

string

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

string

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

string

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

boolean

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

boolean

האם להשבית המרת שיחה עבור הקריאייטיב. אם המדיניות מוגדרת לערך true, המרות מסוג שיחה מושבתות גם אם הערך של callTracked הוא true. אם הערך בשדה callTracked הוא false, המערכת תתעלם מהשדה הזה.
phoneNumberVerificationUrl

string

כתובת ה-URL שתשמש לאימות מספר הטלפון.
conversionAction

string

פעולת ההמרה שאליה רוצים לשייך המרה מסוג שיחה. אם היא לא מוגדרת, המערכת תשתמש בפעולת ההמרה שהוגדרה כברירת מחדל. לשדה הזה יש השפעה רק אם בשדה callTracked מגדירים את הערך true. אחרת, המערכת תתעלם מהשדה הזה.
conversionReportingState

enum (CallConversionReportingState)

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

string

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

string

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

CallConversionReportingState

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
DISABLED פעולת ההמרה מסוג שיחה מושבתת.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION פעולת המרה מסוג שיחה תשתמש בסוג המרת השיחה שהוגדר ברמת החשבון.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION פעולת המרה מסוג שיחה תשתמש בסוג המרה מסוג שיחה שהוגדר ברמת המשאב (מודעות לשיחות בלבד/תוספי שיחה).

ExpandedDynamicSearchAdInfo

מודעת חיפוש דינמית מורחבת.

ייצוג JSON 
{
  "description": string,
  "description2": string
}
שדות
description

string

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

string

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

HotelAdInfo

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

מודעה להזמנת חדרים.

ShoppingSmartAdInfo

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

מודעת שופינג חכמה.

ShoppingProductAdInfo

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

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

ImageAdInfo

מודעת תמונה.

ייצוג JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
שדות
mimeType

enum (MimeType)

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

string (int64 format)

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

string (int64 format)

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

string

כתובת ה-URL של התמונה בגודל מלא.
previewPixelWidth

string (int64 format)

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

string (int64 format)

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

string

כתובת ה-URL של התמונה בגודל התצוגה המקדימה.
name

string

שם התמונה. אם התמונה נוצרה מ-MediaFile, זהו השם של MediaFile. אם התמונה נוצרה מבייטים, השדה הזה ריק.
שדה איחוד image. התמונה שממנה יש ליצור את מודעת התמונה. אפשר לציין את זה באחת משתי דרכים. 1. משאב קיים של MediaFile. 2. נתוני התמונה הגולמיים כבייטים. image יכול להיות רק אחד מהבאים:
mediaFile

string

משאב MediaFile שבו יש להשתמש עבור התמונה.
data

string (bytes format)

נתוני תמונות גולמיים כבייטים.

מחרוזת בקידוד base64.
adIdToCopyImageFrom

string (int64 format)

מזהה מודעה שממנו מעתיקים את התמונה.

MimeType

סוג MIME

טיפוסים בני מנייה (enums)
UNSPECIFIED סוג ה-MIME לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
IMAGE_JPEG סוג MIME של התמונה/jpeg.
IMAGE_GIF סוג MIME של התמונה/ה-GIF.
IMAGE_PNG סוג MIME של התמונה/png.
FLASH סוג MIME של היישום/x-shockwave-Flash.
TEXT_HTML סוג MIME של הטקסט/html.
PDF סוג MIME של האפליקציה/pdf.
MSWORD סוג MIME של האפליקציה/מילת המפתח.
MSEXCEL סוג MIME של application/vnd.ms-excel.
RTF סוג MIME של האפליקציה/rtf.
AUDIO_WAV סוג MIME של Audio/wav.
AUDIO_MP3 סוג MIME של האודיו/mp3.
HTML5_AD_ZIP סוג MIME של application/x-html5-ad-zip.

VideoAdInfo

מודעת וידאו.

ייצוג JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
שדות
video

object (AdVideoAsset)

נכסי הווידאו ב-YouTube ששימשו למודעה.
שדה איחוד format. סכימה ספציפית לפורמט לפורמטים השונים של וידאו. format יכול להיות רק אחד מהבאים:
inStream

object (VideoTrueViewInStreamAdInfo)

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

object (VideoBumperInStreamAdInfo)

פורמט של מודעת וידאו באמפר מסוג In-stream.
outStream

object (VideoOutstreamAdInfo)

פורמט של מודעת וידאו Outstream.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

פורמט של מודעת וידאו In-stream שלא ניתן לדלג עליה.
inFeed

object (InFeedVideoAdInfo)

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

AdVideoAsset

נכס וידאו בתוך מודעה.

ייצוג JSON 
{
  "asset": string
}
שדות
asset

string

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

VideoTrueViewInStreamAdInfo

ייצוג של פורמט מודעת וידאו TrueView In-stream (מודעה שמוצגת במהלך הפעלת סרטון, לעיתים קרובות בתחילת הסרטון), שבה מוצג לחצן דילוג מספר שניות לאחר תחילת הסרטון).

ייצוג JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
שדות
actionButtonLabel

string

התווית בלחצן ה-CTA (קריאה לפעולה) שמעביר את המשתמש לכתובת ה-URL הסופית של מודעת הווידאו. חובה בקמפיינים של TrueView עם קריאה לפעולה. אחרת, אופציונלי.
actionHeadline

string

טקסט נוסף שמוצג עם לחצן ה-CTA (קריאה לפעולה) כדי לתת הקשר ולעודד לחיצה על הלחצן.
companionBanner

object (AdImageAsset)

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

AdImageAsset

נכס תמונות שמופיע במודעה.

ייצוג JSON 
{
  "asset": string
}
שדות
asset

string

שם המשאב של התמונה הזו.

VideoBumperInStreamAdInfo

ייצוג של פורמט מודעת וידאו In-stream (מודעת וידאו In-stream קצרה מאוד שלא ניתן לדלג עליה).

ייצוג JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
שדות
companionBanner

object (AdImageAsset)

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

string

התווית בלחצן 'קריאה לפעולה', שמעביר את המשתמש לכתובת האתר הסופית של מודעת הווידאו.
actionHeadline

string

טקסט נוסף שמוצג עם לחצן ה-CTA (קריאה לפעולה) כדי לתת הקשר ולעודד לחיצה על הלחצן.

VideoOutstreamAdInfo

ייצוג פורמט של מודעת וידאו Outstream (מודעה שמוצגת לצד פיד עם הפעלה אוטומטית, ללא קול).

ייצוג JSON 
{
  "headline": string,
  "description": string
}
שדות
headline

string

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

string

שורת התיאור.

VideoNonSkippableInStreamAdInfo

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

ייצוג JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
שדות
companionBanner

object (AdImageAsset)

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

string

התווית בלחצן 'קריאה לפעולה', שמעביר את המשתמש לכתובת האתר הסופית של מודעת הווידאו.
actionHeadline

string

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

InFeedVideoAdInfo

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

ייצוג JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
שדות
headline

string

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

string

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

string

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

enum (VideoThumbnail)

תמונה ממוזערת של סרטון לשימוש.

VideoThumbnail

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

טיפוסים בני מנייה (enums)
UNSPECIFIED הסוג לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד.
DEFAULT_THUMBNAIL התמונה הממוזערת המוגדרת כברירת מחדל. ניתן ליצור באופן אוטומטי או להעלות את הסרטון על ידי משתמש.
THUMBNAIL_1 תמונה ממוזערת 1, שנוצרה מהסרטון.
THUMBNAIL_2 תמונה ממוזערת 2, שנוצרה מהסרטון.
THUMBNAIL_3 תמונה ממוזערת 3, שנוצרה מהסרטון.

VideoResponsiveAdInfo

מודעת וידאו רספונסיבית.

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
שדות
headlines[]

object (AdTextAsset)

רשימה של נכסי הטקסט המשמשים לכותרת הקצרה. כרגע יש תמיכה רק בערך אחד לכותרת הקצרה.
longHeadlines[]

object (AdTextAsset)

רשימה של נכסי הטקסט שמשמשים לכותרת הארוכה. בשלב הזה יש תמיכה רק בערך אחד לכותרת הארוכה.
descriptions[]

object (AdTextAsset)

רשימה של נכסי טקסט שמשמשים לתיאור. בשלב הזה, יש תמיכה רק בערך אחד לתיאור.
callToActions[]

object (AdTextAsset)

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

object (AdVideoAsset)

רשימה של נכסי הווידאו ב-YouTube שמשמשים עבור המודעה. נכון לעכשיו, יש תמיכה בערך אחד של נכס הווידאו ב-YouTube.
companionBanners[]

object (AdImageAsset)

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

string

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

string

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

AdTextAsset

נכס טקסט שמופיע בתוך מודעה.

ייצוג JSON 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
שדות
pinnedField

enum (ServedAssetFieldType)

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

enum (AssetPerformanceLabel)

תווית הביצועים של נכס הטקסט הזה.
policySummaryInfo

object (AdAssetPolicySummary)

סיכום המדיניות של נכס הטקסט הזה.
text

string

טקסט של נכס.

ServedAssetFieldType

סוגי השדות האפשריים של הנכסים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
HEADLINE_1 הנכס מופיע בכותרת 1.
HEADLINE_2 הנכס מופיע בכותרת 2.
HEADLINE_3 הנכס מופיע בכותרת 3.
DESCRIPTION_1 נעשה שימוש בנכס בתיאור 1.
DESCRIPTION_2 נעשה שימוש בנכס בתיאור 2.
CALL הנכס הזה משמש לקריאה.
MOBILE_APP הנכס הזה משמש כאפליקציה לנייד.
CALLOUT הנכס הזה משמש כנכס יתרונות מרכזיים.
STRUCTURED_SNIPPET הנכס הזה משמש כנכס מידע מובנה.
PRICE הנכס הזה משמש בתור מחיר.
PROMOTION הנכס הזה משמש בתור קידום מכירות.
AD_IMAGE הנכס הזה משמש כתמונה.
LEAD_FORM הנכס משמש כנכס השארת פרטים.

AssetPerformanceLabel

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
PENDING עדיין אין נתונים לגבי הביצועים של הנכס הזה. יכול להיות שהוא עדיין בבדיקה.
LEARNING הנכס התחיל לקבל חשיפות, אבל הנתונים הסטטיסטיים לא מספיק מובהקות סטטיסטית כדי לקבל תווית של ביצועי הנכס.
LOW הנכסים שמניבים את הביצועים הגרועים ביותר.
GOOD נכסים שמניבים ביצועים טובים.
BEST הנכסים שמניבים את הביצועים הטובים ביותר.

AdAssetPolicySummary

מכיל פרטי מדיניות של נכס בתוך מודעה.

ייצוג JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
שדות
policyTopicEntries[]

object (PolicyTopicEntry)

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

enum (PolicyReviewStatus)

איפה נמצא הנכס הזה בתהליך הבדיקה.
approvalStatus

enum (PolicyApprovalStatus)

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

PolicyTopicEntry

מציאת מדיניות שמצורפת למשאב (לדוגמה, מדיניות בנושא אלכוהול המשויכת לאתר שמוכר אלכוהול).

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

ייצוג JSON 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
שדות
type

enum (PolicyTopicEntryType)

מתאר את ההשפעה השלילית או החיובית שתהיה למדיניות הזו על הצגת המודעות.
evidences[]

object (PolicyTopicEvidence)

מידע נוסף שמסביר את מציאת המדיניות (לדוגמה, שם המותג של ממצא של סימן מסחרי).
constraints[]

object (PolicyTopicConstraint)

מציין איך האפשרות להצגת המשאב הזה עשויה להיות מושפעת (לדוגמה, לא מוצגת במדינה).
topic

string

נושא המדיניות שאליו מתייחס ממצא זה. לדוגמה, "ALCOHOL" , "TRADEMARKS_IN_AD_TEXT" או "DESTINATION_NOT_WORKING". הקבוצה של נושאי המדיניות האפשריים לא קבועה בגרסת API מסוימת, והיא עשויה להשתנות בכל שלב.

PolicyTopicEntryType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

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

PolicyTopicEvidence

מידע נוסף שמסביר ממצא במדיניות.

ייצוג JSON 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. מידע ספציפי על ראיות, בהתאם לסוג ההוכחה. value יכול להיות רק אחד מהבאים:
websiteList

object (WebsiteList)

רשימת האתרים שמקושרים למשאב הזה.
textList

object (TextList)

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

string

השפה שבה זיהינו כתיבה של המשאב. זהו תג שפה IETF כמו "en-US".
destinationTextList

object (DestinationTextList)

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

object (DestinationMismatch)

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

object (DestinationNotWorking)

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

WebsiteList

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

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

string

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

TextList

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

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

string

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

DestinationTextList

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

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

string

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

DestinationMismatch

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

ייצוג JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
שדות
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

קבוצה של כתובות URL שלא תאמו זו את זו.

PolicyTopicEvidenceDestinationMismatchUrlType

נושא המדיניות האפשרי הוא עדות לסוגי כתובות URL של חוסר התאמה בין מודעות ליעדיהן.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
DISPLAY_URL כתובת ה-URL לתצוגה.
FINAL_URL כתובת ה-URL הסופית.
FINAL_MOBILE_URL כתובת ה-URL הסופית לנייד.
TRACKING_URL התבנית של כתובת ה-URL למעקב, עם כתובת ה-URL החלופית למחשב.
MOBILE_TRACKING_URL תבנית כתובת ה-URL למעקב עם כתובת URL חלופית לנייד.

DestinationNotWorking

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

ייצוג JSON 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
שדות
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

סוג המכשיר שטעינת כתובת ה-URL שלו נכשלה.
expandedUrl

string

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

string

המועד האחרון שבו נבדקה כתובת ה-URL. הפורמט הוא 'YYYY-MM-DD HH:MM:SS'. לדוגמה: 2018-03-05 09:15:00 או 2018-02-01 14:34:30
שדה איחוד reason. מציין את הסיבה לממצא המדיניות DESTINATION_NOT_WORKING. reason יכול להיות רק אחד מהבאים:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

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

string (int64 format)

קוד שגיאת ה-HTTP

PolicyTopicEvidenceDestinationNotWorkingDevice

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
DESKTOP דף הנחיתה לא פועל במחשב.
ANDROID דף הנחיתה לא פועל במכשיר Android.
IOS דף הנחיתה לא פועל במכשיר iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

היעד האפשרי של ההוכחה לנושא המדיניות לא פועל עם סוגי שגיאות ה-DNS.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
HOSTNAME_NOT_FOUND שם המארח לא נמצא ב-DNS במהלך אחזור דף הנחיתה.
GOOGLE_CRAWLER_DNS_ISSUE בעיה בסורק הפנימי של Google במהלך תקשורת עם DNS. זה לא אומר שדף הנחיתה לא פועל. Google תסרוק מחדש את דף הנחיתה.

PolicyTopicConstraint

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

ייצוג JSON 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. מידע ספציפי על האילוץ. value יכול להיות רק אחד מהבאים:
countryConstraintList

object (CountryConstraintList)

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

object (ResellerConstraint)

אילוץ של מפיץ.
certificateMissingInCountryList

object (CountryConstraintList)

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

object (CountryConstraintList)

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

CountryConstraintList

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

ייצוג JSON 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
שדות
countries[]

object (CountryConstraint)

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

integer

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

CountryConstraint

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

ייצוג JSON 
{
  "countryCriterion": string
}
שדות
countryCriterion

string

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

ResellerConstraint

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

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

PolicyReviewStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

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

PolicyApprovalStatus

הסטטוסים האפשריים של אישור המדיניות. כשיש כמה סטטוסים זמינים של אישור, המערכת תשתמש בסטטוס החמור ביותר. סדר החומרה הוא DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED ו-APPROVED.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

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

ResponsiveSearchAdInfo

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

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

מידע נוסף זמין בכתובת https://support.google.com/google-ads/answer/7684791

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
שדות
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

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

string

החלק הראשון של הטקסט שניתן לצרף לכתובת ה-URL במודעה.
path2

string

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

LegacyResponsiveDisplayAdInfo

מודעה רספונסיבית מדור קודם לרשת המדיה. מודעות מהסוג הזה מתויגות כ 'מודעות רספונסיביות' בממשק המשתמש של Google Ads.

ייצוג JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
שדות
formatSetting

enum (DisplayAdFormatSetting)

ציון הפורמט שבו המודעה תוצג. ברירת המחדל היא ALL_FORMATS.
shortHeadline

string

הגרסה הקצרה של כותרת המודעה.
longHeadline

string

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

string

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

string

שם העסק שמוצג במודעה.
allowFlexibleColor

boolean

הסכמת המפרסם לאפשר שימוש בצבע גמיש. אם הערך הוא True, המודעה יכולה להופיע בצבע שונה בהתאם לצורך. אם הערך הוא False, המודעה תוצג בצבעים שצוינו או בצבע ניטרלי. ערך ברירת המחדל הוא true. הערך חייב להיות True אם mainColor ו-accentColor לא מוגדרים.
accentColor

string

צבע ההדגשה של המודעה בהקסדצימלית, לדוגמה, #תתאים ללבן. אם מגדירים אחד מהשניים mainColor ו-accentColor, גם השני נדרש.
mainColor

string

הצבע העיקרי של המודעה בהקסדצימלי, לדוגמה, #⌘ ללבן. אם מגדירים אחד מהשניים mainColor ו-accentColor, גם השני נדרש.
callToActionText

string

טקסט הקריאה לפעולה במודעה.
logoImage

string

שם המשאב של MediaFile של תמונת הלוגו שמופיעה במודעה.
squareLogoImage

string

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

string

שם המשאב של MediaFile של התמונה השיווקית שנעשה בה שימוש במודעה.
squareMarketingImage

string

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

string

מוסיפים תחילית לפני המחיר. לדוגמה, 'החל מ-'.
promoText

string

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

DisplayAdFormatSetting

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
ALL_FORMATS פורמטים של טקסט, תמונה ופורמטים מותאמים.
NON_NATIVE פורמטים של טקסט ותמונה.
NATIVE בפורמט מקורי, לדוגמה, עיבוד הפורמט נשלט על ידי בעל התוכן הדיגיטלי ולא על ידי Google.

AppAdInfo

מודעה לאפליקציה.

ייצוג JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
שדות
mandatoryAdText

object (AdTextAsset)

טקסט חובה במודעה.
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

רשימה של נכסי טקסט לתיאורים. המועד שבו התיאורים יוצגו במודעה ייבחרו מהרשימה הזו.
images[]

object (AdImageAsset)

רשימה של נכסי תמונות שייתכן שיוצגו עם המודעה.
youtubeVideos[]

object (AdVideoAsset)

רשימה של נכסי וידאו ב-YouTube שניתן להציג עם המודעה.
html5MediaBundles[]

object (AdMediaBundleAsset)

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

AdMediaBundleAsset

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

ייצוג JSON 
{
  "asset": string
}
שדות
asset

string

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

LegacyAppInstallAdInfo

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

ייצוג JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
שדות
appStore

enum (LegacyAppInstallAdAppStore)

חנות האפליקציות שבה האפליקציה לנייד זמינה.
appId

string

המזהה של האפליקציה לנייד.
headline

string

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

string

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

string

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

LegacyAppInstallAdAppStore

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE חנות Windows.
WINDOWS_PHONE_STORE חנות Windows Phone
CN_APP_STORE האפליקציה מתארחת בחנות אפליקציות סינית.

ResponsiveDisplayAdInfo

מודעה רספונסיבית לרשת המדיה.

ייצוג JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
שדות
marketingImages[]

object (AdImageAsset)

תמונות שיווקיות שייעשה בהן שימוש במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 600x314 ויחס הגובה-רוחב חייב להיות 1.91:1 (+-1%). יש צורך לפחות בשדה marketingImage. בשילוב עם squareMarketingImages, המקסימום הוא 15.
squareMarketingImages[]

object (AdImageAsset)

תמונות שיווק מרובעות שאפשר להוסיף למודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 300x300 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). יש לציין לפחות ריבוע אחד מסוג marketingImage. בשילוב עם marketingImages, המקסימום הוא 15.
logoImages[]

object (AdImageAsset)

תמונות לוגו שייעשה בהן שימוש במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 512x128 ויחס הגובה-רוחב חייב להיות 4:1 (+-1%). בשילוב עם squareLogoImages, המקסימום הוא 5.
squareLogoImages[]

object (AdImageAsset)

תמונות לוגו ריבועיות שיוצגו במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). בשילוב עם logoImages, המקסימום הוא 5.
headlines[]

object (AdTextAsset)

כותרות בפורמט קצר עבור המודעה. האורך המקסימלי הוא 30 תווים. אפשר לציין לפחות כותרת אחת ועד 5 כותרות.
longHeadline

object (AdTextAsset)

נדרשת כותרת ארוכה בפורמט. האורך המקסימלי הוא 90 תווים.
descriptions[]

object (AdTextAsset)

טקסטים תיאוריים למודעה. האורך המקסימלי הוא 90 תווים. אפשר לציין לפחות כותרת אחת ועד 5 כותרות.
youtubeVideos[]

object (AdVideoAsset)

סרטוני YouTube אופציונליים עבור המודעה. אפשר לציין עד 5 סרטונים.
formatSetting

enum (DisplayAdFormatSetting)

ציון הפורמט שבו המודעה תוצג. ברירת המחדל היא ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

מפרט לפקדי קריאייטיב שונים.
businessName

string

שם המפרסם/המותג. רוחב התצוגה המקסימלי הוא 25.
mainColor

string

הצבע העיקרי של המודעה בהקסדצימלי, לדוגמה, #⌘ ללבן. אם מגדירים אחד מהשניים mainColor ו-accentColor, גם השני נדרש.
accentColor

string

צבע ההדגשה של המודעה בהקסדצימלית, לדוגמה, #תתאים ללבן. אם מגדירים אחד מהשניים mainColor ו-accentColor, גם השני נדרש.
allowFlexibleColor

boolean

הסכמת המפרסם לאפשר שימוש בצבע גמיש. אם הערך הוא True, המודעה יכולה להופיע בצבע שונה בהתאם לצורך. אם הערך הוא False, המודעה תוצג בצבעים שצוינו או בצבע ניטרלי. ערך ברירת המחדל הוא true. הערך חייב להיות True אם mainColor ו-accentColor לא מוגדרים.
callToActionText

string

טקסט הקריאה לפעולה במודעה. רוחב התצוגה המקסימלי הוא 30.
pricePrefix

string

מוסיפים תחילית לפני המחיר. לדוגמה, 'החל מ-'.
promoText

string

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

ResponsiveDisplayAdControlSpec

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

ייצוג JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
שדות
enableAssetEnhancements

boolean

האם המפרסם הביע הסכמה לשימוש בתכונה 'שיפורי נכסים'.
enableAutogenVideo

boolean

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

LocalAdInfo

מודעה מקומית.

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
שדות
headlines[]

object (AdTextAsset)

רשימה של נכסי טקסט לכותרות. כאשר המודעה תוצג, הכותרות ייבחרו מהרשימה הזו. יש לציין לפחות כותרת אחת ולא יותר מ-5.
descriptions[]

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

רשימת נכסים של תמונות שיווקיות שייתכן שיוצגו עם המודעה. התמונות חייבות להיות בגודל 314x600 פיקסלים או 320x320 פיקסלים. יש לציין נכס תמונה אחד לכל היותר.
logoImages[]

object (AdImageAsset)

רשימת נכסים של תמונות לוגו שייתכן שיוצגו עם המודעה. התמונות צריכות להיות בגודל של 128x128 פיקסלים ולא יותר מ-120KB. יש לציין לפחות נכס תמונה אחד ולא יותר מ-5.
videos[]

object (AdVideoAsset)

רשימה של נכסי וידאו ב-YouTube שניתן להציג עם המודעה. יש לציין נכס וידאו אחד לכל היותר.
path1

string

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

string

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

DisplayUploadAdInfo

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

ייצוג JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
שדות
displayUploadProductType

enum (DisplayUploadProductType)

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

object (AdMediaBundleAsset)

נכס של חבילת מדיה לשימוש במודעה. מידע על חבילת המדיה עבור HTML5_UPLOAD_AD זמין במאמר https://support.google.com/google-ads/answer/1722096 חבילות מדיה שהן חלק מסוגי מוצרים דינמיים בפורמט מיוחד שיש ליצור באמצעות Google Web Designer. מידע נוסף זמין בכתובת https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
HTML5_UPLOAD_AD מודעה להעלאה בפורמט HTML5. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD מודעת HTML5 דינמית לחינוך. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין רק בקמפיין חינוכי.
DYNAMIC_HTML5_FLIGHT_AD מודעת טיסה דינמית ב-HTML5. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין טיסה.
DYNAMIC_HTML5_HOTEL_RENTAL_AD מודעת HTML5 דינמית למלונות וליחידות נופש להשכרה. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין לקידום מלון.
DYNAMIC_HTML5_JOB_AD מודעת משרה דינמית מסוג HTML5. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש רק בקמפיין לקידום עבודה.
DYNAMIC_HTML5_LOCAL_AD מודעת HTML5 מקומית דינמית. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין מקומי.
DYNAMIC_HTML5_REAL_ESTATE_AD מודעת נדל"ן דינמית מסוג HTML5. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיינים לקידום נדל"ן.
DYNAMIC_HTML5_CUSTOM_AD מודעת HTML5 דינמית בהתאמה אישית. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. ניתן להשתמש רק בקמפיין בהתאמה אישית.
DYNAMIC_HTML5_TRAVEL_AD מודעת HTML5 דינמית לנסיעות. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין ל-Google נסיעות.
DYNAMIC_HTML5_HOTEL_AD מודעת HTML5 דינמית לקידום מלון. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין לקידום מלון.

AppEngagementAdInfo

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

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
שדות
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

רשימה של נכסי טקסט לתיאורים. המועד שבו התיאורים יוצגו במודעה ייבחרו מהרשימה הזו.
images[]

object (AdImageAsset)

רשימה של נכסי תמונות שייתכן שיוצגו עם המודעה.
videos[]

object (AdVideoAsset)

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

ShoppingComparisonListingAdInfo

מודעת השוואת מחירים.

ייצוג JSON 
{
  "headline": string
}
שדות
headline

string

הכותרת של המודעה. חובה לבחור אפשרות לשדה הזה. האורך המותר הוא בין 25 ל-45 תווים.

SmartCampaignAdInfo

מודעה בקמפיין חכם.

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
שדות
headlines[]

object (AdTextAsset)

רשימה של נכסי טקסט, שכל אחד מהם תואם לכותרת בזמן שהמודעה מוצגת. רשימה זו כוללת לפחות 3 ועד 15 נכסי טקסט.
descriptions[]

object (AdTextAsset)

רשימה של נכסי טקסט, שכל אחד מהם תואם לתיאור של המודעה. רשימה זו כוללת לפחות 2 ועד 4 נכסי טקסט.

AppPreRegistrationAdInfo

מודעות לרישום מראש של אפליקציות מקשרות לדף האפליקציה או המשחק ב-Google Play, ויכולות להופיע ב-Google Play, ב-YouTube (מודעות וידאו In-stream בלבד) ובאפליקציות אחרות ובאתרים אחרים לנייד ברשת המדיה. זה יעזור לעורר עניין של אנשים באפליקציה או במשחק שלכם וליצור בסיס התקנות מוקדם של האפליקציה או המשחק, לפני ההשקה.

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
שדות
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

רשימה של נכסי טקסט לתיאורים. המועד שבו התיאורים יוצגו במודעה ייבחרו מהרשימה הזו.
images[]

object (AdImageAsset)

רשימת מזהים של נכסי תמונות שניתן להציג את התמונות שלהם עם המודעה.
youtubeVideos[]

object (AdVideoAsset)

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

DiscoveryMultiAssetAdInfo

מודעת Discovery מרובת נכסים.

ייצוג JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
שדות
marketingImages[]

object (AdImageAsset)

נכסי תמונות שיווקיים שיצורפו למודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 600x314 ויחס הגובה-רוחב חייב להיות 1.91:1 (+-1%). נדרש אם SquareMarketingImages לא זמינה. בשילוב עם squareMarketingImages ו-portraitMarketingImages, המקסימום הוא 20.
squareMarketingImages[]

object (AdImageAsset)

נכסי תמונות שיווקיות מרובעות שיוצגו במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 300x300 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). חובה אם לא מופיעות תמונות שיווקיות. בשילוב עם marketingImages ו-portraitMarketingImages, המקסימום הוא 20.
portraitMarketingImages[]

object (AdImageAsset)

נכסי תמונות שיווקיות לאורך שמיועדים לשימוש במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 480x600 ויחס הגובה-רוחב חייב להיות 4:5 (+-1%). בשילוב עם marketingImages ו-squareMarketingImages, המקסימום הוא 20.
logoImages[]

object (AdImageAsset)

נכסים של תמונות לוגו שיצורפו למודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). ניתן לציין לפחות תמונת לוגו אחת ולא יותר מ-5 תמונות לוגו.
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

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

string

שם המפרסם/המותג. רוחב התצוגה המקסימלי הוא 25. חובה.
callToActionText

string

טקסט של קריאה לפעולה.
leadFormOnly

boolean

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

DiscoveryCarouselAdInfo

מודעת קרוסלה Discovery.

ייצוג JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
שדות
businessName

string

חובה. שם המפרסם/המותג.
logoImage

object (AdImageAsset)

חובה. תמונת לוגו שתוצג במודעה. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%).
headline

object (AdTextAsset)

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

object (AdTextAsset)

חובה. הטקסט התיאורי של המודעה.
callToActionText

string

טקסט של קריאה לפעולה.
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

חובה. כרטיסי קרוסלה שיוצגו עם המודעה. מינימום 2 עד 10.

AdDiscoveryCarouselCardAsset

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

ייצוג JSON 
{
  "asset": string
}
שדות
asset

string

שם משאב הנכס בכרטיס קרוסלה Discovery הזה.

DiscoveryVideoResponsiveAdInfo

מודעת וידאו רספונסיבית מסוג Discovery.

ייצוג JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
שדות
headlines[]

object (AdTextAsset)

רשימה של נכסי הטקסט המשמשים לכותרת הקצרה.
longHeadlines[]

object (AdTextAsset)

רשימה של נכסי הטקסט שמשמשים לכותרת הארוכה.
descriptions[]

object (AdTextAsset)

רשימה של נכסי טקסט שמשמשים לתיאור.
videos[]

object (AdVideoAsset)

רשימה של נכסי הווידאו ב-YouTube שמשמשים עבור המודעה.
logoImages[]

object (AdImageAsset)

תמונת לוגו שתוצג במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%).
breadcrumb1

string

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

string

החלק השני של הטקסט שמופיע במודעה עם כתובת ה-URL המוצגת.
businessName

object (AdTextAsset)

חובה. שם המפרסם/המותג.
callToActions[]

object (AdCallToActionAsset)

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

AdCallToActionAsset

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

ייצוג JSON 
{
  "asset": string
}
שדות
asset

string

שם משאב הנכס של נכס הקריאה לפעולה הזה.

TravelAdInfo

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

מודעה לנסיעות.

שיטות

get

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

mutate

 מעדכנות מודעות.