Asset

נכס הוא חלק ממודעה שאפשר לשתף בין מספר מודעות. זה יכול להיות תמונה (ImageAsset), סרטון (YouTubeVideoAsset) וכו'. אי אפשר לשנות את הנכסים ולכן לא ניתן להסיר אותם. כדי להפסיק את ההצגה של נכס, צריך להסיר את הנכס מהישות שמשתמשת בו.

ייצוג JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
שדות
resourceName

string

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

customers/{customerId}/assets/{asset_id}
type

enum (AssetType)

פלט בלבד. סוג הנכס.
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
finalMobileUrls[]

string

רשימה של כתובות דף סופיות בנייד אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים.
urlCustomParameters[]

object (CustomParameter)

רשימת מיפויים שישמשו להחלפת תגים של פרמטרים מותאמים אישית של כתובות URL ב-TrackingUrlTemplate, ב-FinalUrls וב-FinalMobileUrls.
source

enum (AssetSource)

פלט בלבד. מקור הנכס.
policySummary

object (AssetPolicySummary)

פלט בלבד. פרטי מדיניות של הנכס.
fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

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

string (int64 format)

פלט בלבד. מזהה הנכס.
name

string

שם אופציונלי של הנכס.
trackingUrlTemplate

string

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

string

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

object (YoutubeVideoAsset)

בלתי משתנה. נכס וידאו ב-YouTube.
mediaBundleAsset

object (MediaBundleAsset)

בלתי משתנה. נכס של חבילת מדיה.
imageAsset

object (ImageAsset)

פלט בלבד. נכס תמונות.
textAsset

object (TextAsset)

בלתי משתנה. נכס טקסט.
leadFormAsset

object (LeadFormAsset)

נכס השארת פרטים.
bookOnGoogleAsset

object (BookOnGoogleAsset)

נכס של ספר ב-Google.
promotionAsset

object (PromotionAsset)

נכס קידום מכירות.
calloutAsset

object (CalloutAsset)

נכס יתרונות מרכזיים.
structuredSnippetAsset

object (StructuredSnippetAsset)

נכס מידע מובנה.
pageFeedAsset

object (PageFeedAsset)

נכס של פיד דפי נחיתה.
dynamicEducationAsset

object (DynamicEducationAsset)

נכס חינוכי דינמי.
mobileAppAsset

object (MobileAppAsset)

נכס אפליקציה לנייד.
hotelCalloutAsset

object (HotelCalloutAsset)

נכס יתרונות מרכזיים של מלון.
callAsset

object (CallAsset)

נכס התקשרות.
priceAsset

object (PriceAsset)

נכס מחיר.
callToActionAsset

object (CallToActionAsset)

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

object (DynamicRealEstateAsset)

נכס נדל"ן דינמי.
dynamicCustomAsset

object (DynamicCustomAsset)

נכס דינמי בהתאמה אישית.
dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

נכס דינמי של מלונות ויחידות נופש להשכרה.
dynamicFlightsAsset

object (DynamicFlightsAsset)

נכס טיסות דינמי.
dynamicTravelAsset

object (DynamicTravelAsset)

נכס נסיעות דינמי.
dynamicLocalAsset

object (DynamicLocalAsset)

נכס מקומי דינמי.
dynamicJobsAsset

object (DynamicJobsAsset)

נכס משרות דינמי.
locationAsset

object (LocationAsset)

פלט בלבד. נכס מיקום.
hotelPropertyAsset

object (HotelPropertyAsset)

בלתי משתנה. נכס של נכס מלון.

AssetType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
YOUTUBE_VIDEO נכס וידאו ב-YouTube.
MEDIA_BUNDLE נכס של חבילת מדיה.
IMAGE נכס תמונות.
TEXT נכס טקסט.
LEAD_FORM נכס השארת פרטים.
BOOK_ON_GOOGLE נכס הזמנה דרך Google.
PROMOTION נכס קידום מכירות.
CALLOUT נכס יתרונות מרכזיים.
STRUCTURED_SNIPPET נכס מידע מובנה.
PAGE_FEED נכס של פיד דפי נחיתה.
DYNAMIC_EDUCATION נכס דיגיטלי דינמי שקשור ללימודים.
MOBILE_APP נכס אפליקציה לנייד.
HOTEL_CALLOUT נכס יתרונות מרכזיים של מלון.
CALL נכס התקשרות.
PRICE נכס מחיר.
CALL_TO_ACTION נכס של קריאה לפעולה.
DYNAMIC_REAL_ESTATE נכס נדל"ן דינמי.
DYNAMIC_CUSTOM נכס דינמי בהתאמה אישית.
DYNAMIC_HOTELS_AND_RENTALS נכס דינמי של מלונות ויחידות נופש להשכרה.
DYNAMIC_FLIGHTS נכס טיסות דינמי.
DYNAMIC_TRAVEL נכס נסיעות דינמי.
DYNAMIC_LOCAL נכס מקומי דינמי.
DYNAMIC_JOBS נכס דינמי שקשור למשרות.
LOCATION נכס מיקום.
HOTEL_PROPERTY נכס של נכס מלון.

AssetPolicySummary

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

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

object (PolicyTopicEntry)

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

enum (PolicyReviewStatus)

פלט בלבד. המיקום של הנכס הזה בתהליך הבדיקה.
approvalStatus

enum (PolicyApprovalStatus)

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

AssetFieldTypePolicySummary

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

ייצוג JSON 
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
שדות
assetFieldType

enum (AssetFieldType)

פלט בלבד. FieldType של הנכס הזה.
assetSource

enum (AssetSource)

פלט בלבד. מקור הנכס הזה.
policySummaryInfo

object (AssetPolicySummary)

פלט בלבד. סיכום מדיניות.

YoutubeVideoAsset

נכס ב-YouTube.

ייצוג JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
שדות
youtubeVideoTitle

string

שם הסרטון ב-YouTube.
youtubeVideoId

string

מזהה הווידאו ב-YouTube. זהו ערך של מחרוזת באורך 11 תווים המשמש בכתובת ה-URL של סרטון YouTube.

MediaBundleAsset

נכס של MediaBundle.

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

string (bytes format)

נתוני נכס של חבילת מדיה (קובץ ZIP). הפורמט של קובץ ה-ZIP שהועלה תלוי בשדה המודעה שבו ייעשה שימוש בקובץ. למידע נוסף על הפורמט, אפשר לעיין במסמכי התיעוד של שדה המודעה שבו אתם מתכננים להשתמש ב-MediaBundleAsset. ניתן לשנות שדה זה בלבד.

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

ImageAsset

נכס תמונות.

ייצוג JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
שדות
mimeType

enum (MimeType)

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

object (ImageDimension)

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

string (bytes format)

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

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

string (int64 format)

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

ImageDimension

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

ייצוג JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
שדות
heightPixels

string (int64 format)

גובה התמונה.
widthPixels

string (int64 format)

רוחב התמונה.
url

string

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

TextAsset

נכס טקסט.

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

string

תוכן הטקסט של נכס הטקסט.

LeadFormAsset

נכס השארת פרטים.

ייצוג JSON 
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
שדות
businessName

string

חובה. שם העסק שמופיע במודעות.
callToActionType

enum (LeadFormCallToActionType)

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

string

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

string

חובה. כותרת של הטופס המורחב, שמתארת מה מבקש או מאפשר הטופס.
description

string

חובה. תיאור מפורט של הטופס המורחב, כדי לתאר מה הטופס מבקש או מאפשר.
privacyPolicyUrl

string

חובה. קישור לדף שמתאר את המדיניות לגבי אופן הטיפול של המפרסם/העסק בנתונים שנאספו.
fields[]

object (LeadFormField)

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

object (LeadFormCustomQuestionField)

רשימה ממוינת של שדות שאלה בהתאמה אישית. השדה הזה מוגבל ל-5 שאלות לבדיקת התאמה בכל טופס.
deliveryMethods[]

object (LeadFormDeliveryMethod)

שיטות שהוגדרו לשליחה של נתוני לידים שנאספו למפרסם. אפשר להגדיר רק שיטה אחת שהוקלדה כ-Webhook Delivery.
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

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

enum (LeadFormDesiredIntent)

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

string

כותרת טקסט שמוצגת לאחר שליחת טופס, שמתארת איך המפרסם ייצור קשר עם המשתמש.
postSubmitDescription

string

תיאור מפורט שמוצג לאחר שליחת הטופס ומתאר איך המפרסם ייצור קשר עם המשתמש.
backgroundImageAsset

string

שם המשאב של תמונת הרקע. מידות התמונה חייבות להיות 1200x628 בדיוק.
customDisclosure

string

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

LeadFormCallToActionType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
LEARN_MORE מידע נוסף
GET_QUOTE קבלו הצעת מחיר.
APPLY_NOW כדאי להגיש בקשה עוד היום.
SIGN_UP הרשמה.
CONTACT_US יצירת קשר איתנו.
SUBSCRIBE הרשמה.
DOWNLOAD הורדה בכל מקום באפליקציית YouTube Music שבו אתם רואים פלייליסט או אלבום.
BOOK_NOW הזמינו עכשיו.
GET_OFFER מקבלים את המבצע.
REGISTER הרשמה.
GET_INFO קבלת מידע.
REQUEST_DEMO בקשת הדגמה (דמו).
JOIN_NOW להצטרפות עכשיו.
GET_STARTED קדימה, מתחילים

LeadFormField

מופע אחד של שדה קלט בתוך טופס.

ייצוג JSON 
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
שדות
inputType

enum (LeadFormFieldUserInputType)

מיועד לתיאור סוג הקלט, שיכול להיות סוג מוגדר מראש כמו 'שם מלא' או שאלה שכבר בודקים, כמו 'איזה סוג של רכב יש לך?'.
שדה איחוד answers. הגדרת התצורה של התשובות ששדה הטופס הזה מקבל. אם אחד מהערכים לא מוגדר, זוהי תשובה בטקסט חופשי. answers יכול להיות רק אחד מהבאים:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

הגדרת תשובה לשאלה מסוג בחירה יחידה. אפשר להגדיר אותן רק לשדות שאלות שנבדקו מראש. נדרשות לפחות 2 תשובות ומותר להוסיף 12 תשובות לכל היותר.
hasLocationAnswer

boolean

הגדרת תשובה לשאלה שקשורה למיקום. אם הערך הוא True, נתוני המיקום ברמת הקמפיין או ברמת החשבון (מדינה, עיר, שם העסק וכו') יוצגו בטופס להשארת פרטים. החל מגרסה 13.1, ניתן להגדיר את hasLocationAnswer רק לשאלה "מהי הסוכנות המועדפת עליך?", למפרסמים שהגדירו נכסי מיקום ברמת הקמפיין או החשבון.

LeadFormSingleChoiceAnswers

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

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

string

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

LeadFormCustomQuestionField

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

ייצוג JSON 
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
שדות
customQuestionText

string

הטקסט המדויק בשדה של השאלה בהתאמה אישית (לדוגמה, "איזה סוג רכב יש לך?").
שדה איחוד answers. הגדרת התצורה של התשובות ששדה הטופס הזה מקבל. אם אחד מהערכים לא מוגדר, זוהי תשובה בטקסט חופשי. answers יכול להיות רק אחד מהבאים:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

הגדרת תשובה לשאלה מסוג בחירה יחידה. מותר להוסיף 2 תשובות לכל הפחות ו-12 תשובות לכל היותר.
hasLocationAnswer

boolean

הגדרת תשובה לשאלה שקשורה למיקום. אם הערך הוא True, נתוני המיקום ברמת הקמפיין או ברמת החשבון (מדינה, עיר, שם העסק וכו') יוצגו בטופס להשארת פרטים. החל מגרסה 13.1, ניתן להגדיר את hasLocationAnswer רק לשאלה "מהי הסוכנות המועדפת עליך?", למפרסמים שהגדירו נכסי מיקום ברמת הקמפיין או החשבון.

LeadFormDeliveryMethod

הגדרה של האופן שבו הלידים נשלחים למפרסם.

ייצוג JSON 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
שדות
שדה איחוד delivery_details. סוגים שונים של משלוחים. delivery_details יכול להיות רק אחד מהבאים:
webhook

object (WebhookDelivery)

שיטת ההצגה של תגובה לפעולה מאתר אחר (webhook).

WebhookDelivery

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

ייצוג JSON 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
שדות
advertiserWebhookUrl

string

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

string

הסוד למניעת זיוף שהוגדר על ידי המפרסם כחלק מהמטען הייעודי (payload) של התגובה לפעולה מאתר אחר (webhook).
payloadSchemaVersion

string (int64 format)

גרסת הסכימה שבה תשתמש מכונת המסירה הזו.

LeadFormPostSubmitCallToActionType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
VISIT_SITE כניסה לאתר.
DOWNLOAD הורדה בכל מקום באפליקציית YouTube Music שבו אתם רואים פלייליסט או אלבום.
LEARN_MORE מידע נוסף
SHOP_NOW קנו עכשיו.

LeadFormDesiredIntent

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

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

BookOnGoogleAsset

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

נכס של 'הזמנה דרך Google'. משמש להפניה אוטומטית של המשתמש להזמנה דרך Google. התכונה 'הזמנה דרך Google' תשנה את כתובת ה-URL להפניה אוטומטית כדי להזמין ישירות דרך Google.

PromotionAsset

נכס קידום מכירות.

ייצוג JSON 
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
שדות
promotionTarget

string

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

enum (PromotionExtensionDiscountModifier)

ערך לשינוי התאמת ההנחה.
redemptionStartDate

string

תאריך ההתחלה שבו ניתן לממש את המבצע, בפורמט yyyy-MM-dd.
redemptionEndDate

string

התאריך האחרון שבו ניתן לממש את המבצע, בפורמט yyyy-MM-dd.
occasion

enum (PromotionExtensionOccasion)

האירוע שעבורו המבצע היה מיועד. אם הוגדר אירוע, חלון המימוש צריך להיות בטווח התאריכים המשויך לאירוע.
languageCode

string

השפה של המבצע. מיוצג כתג שפה BCP 47.
startDate

string

תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול.
שדה איחוד discount_type. סוג הנחה, יכול להיות הנחה באחוזים או הנחה באחוזים. discount_type יכול להיות רק אחד מהבאים:
percentOff

string (int64 format)

אחוז הנחה בקידום המכירות. 1,000,000 = 100%. יש לציין את הערך הזה או את השדהMoneyAmountDisabled.
moneyAmountOff

object (Money)

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

string

קוד שהמשתמש צריך להשתמש בו כדי להיות זכאי לקידום.
ordersOverAmount

object (Money)

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

CalloutAsset

נכס יתרונות מרכזיים.

ייצוג JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
שדות
calloutText

string

חובה. טקסט היתרונות המרכזיים. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
startDate

string

תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול.

StructuredSnippetAsset

נכס מידע מובנה.

ייצוג JSON 
{
  "header": string,
  "values": [
    string
  ]
}
שדות
header

string

חובה. הכותרת של קטע הטקסט. המחרוזת הזו צריכה להיות אחד מהערכים המוגדרים מראש בכתובת https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
values[]

string

חובה. הערכים בקטע הקוד. גודל האוסף צריך להיות בין 3 ל-10, כולל. האורך של כל ערך צריך להיות בין 1 ל-25 תווים, כולל.

SitelinkAsset

נכס Sitelink.

ייצוג JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
שדות
linkText

string

חובה. טקסט התצוגה של כתובת ה-URL עבור ה-Sitelink. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
description1

string

השורה הראשונה של התיאור של ה-Sitelink. אם הוא מוגדר, האורך צריך להיות בין 1 ל-35, כולל, וגם יש להגדיר את תיאור2.
description2

string

השורה השנייה בתיאור של ה-Sitelink. אם המאפיין מוגדר, האורך צריך להיות בין 1 ל-35, כולל, וגם יש להגדיר תיאור1.
startDate

string

תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול.

PageFeedAsset

נכס של פיד דפי נחיתה.

ייצוג JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
שדות
pageUrl

string

חובה. דף האינטרנט שהמפרסמים רוצים למקד אליו.
labels[]

string

תוויות המשמשות לקיבוץ כתובות ה-URL של הדפים.

DynamicEducationAsset

נכס חינוכי דינמי.

ייצוג JSON 
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
שדות
programId

string

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

string

מזהה מיקום שיכול להיות כל רצף של אותיות וספרות והוא חייב להיות ייחודי.
programName

string

חובה. שם התוכנית. לדוגמה, סיעוד. חובה.
subject

string

נושא המחקר, למשל בריאות.
programDescription

string

תיאור התוכנית, למשל הסמכה לסיעוד.
schoolName

string

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

string

כתובת בית הספר שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה: 41.40338, 2.17403
contextualKeywords[]

string

מילות מפתח לפי הקשר, לדוגמה: הסמכה בסיעוד, בריאות, תל אביב.
similarProgramIds[]

string

מזהי תוכניות דומים.
iosAppStoreId

string (int64 format)

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

string

כתובת URL של תמונה ממוזערת, למשל: http://www.example.com/thumbnail.png. התמונה הממוזערת לא תועלה כנכס תמונות.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.

MobileAppAsset

נכס שמייצג אפליקציה לנייד.

ייצוג JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
שדות
appId

string

חובה. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד. הוא צריך להכיל רק את מזהה הפלטפורמה המקורי, כמו "com.android.ebay" ל-Android או "12345689" ל-iOS.
appStore

enum (MobileAppVendor)

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

string

חובה. הטקסט הגלוי שמוצג בזמן עיבוד הקישור במודעה. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
startDate

string

תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd.

HotelCalloutAsset

נכס שמייצג יתרונות מרכזיים של מלון.

ייצוג JSON 
{
  "text": string,
  "languageCode": string
}
שדות
text

string

חובה. הטקסט של נכס היתרונות המרכזיים של המלון. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
languageCode

string

חובה. השפה של היתרונות המרכזיים של המלון. מיוצג כתג שפה BCP 47.

CallAsset

נכס התקשרות.

ייצוג JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
שדות
countryCode

string

חובה. קוד מדינה בן שתי אותיות של מספר הטלפון. לדוגמה: 'US', 'us'.
phoneNumber

string

חובה. מספר הטלפון הגולמי של המפרסם. דוגמאות: '1234567890', '(123)456-7890'
callConversionReportingState

enum (CallConversionReportingState)

מציין אם CallAsset הזה צריך להשתמש בהגדרה משלו של המרת שיחה, בהתאם להגדרה ברמת החשבון או להשבית את המרת השיחה.
callConversionAction

string

פעולת ההמרה שאליה רוצים לשייך המרה מסוג שיחה. אם המדיניות לא מוגדרת, המערכת תשתמש בפעולת ההמרה שהוגדרה כברירת מחדל. השדה הזה רלוונטי רק אם הערך callConversionReportingState מוגדר לערך USE_Resource_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול.

PriceAsset

נכס שמייצג רשימה של הצעות מחיר.

ייצוג JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
שדות
type

enum (PriceExtensionType)

חובה. הסוג של נכס המחיר.
priceQualifier

enum (PriceExtensionPriceQualifier)

תוחם המחיר של נכס המחיר.
languageCode

string

חובה. השפה שבה כתוב נכס המחיר. מיוצג כתג שפה BCP 47.
priceOfferings[]

object (PriceOffering)

הצעות המחיר של נכס המחיר. גודל האוסף צריך להיות בין 3 ל-8, כולל.

PriceOffering

הצעת מחיר אחידה בנכס PriceAsset.

ייצוג JSON 
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
שדות
header

string

חובה. הכותרת של הצעת המחיר. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
description

string

חובה. תיאור המחיר המוצע. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל.
price

object (Money)

חובה. ערך המחיר של ההצעה.
unit

enum (PriceExtensionPriceUnit)

יחידת המחיר של הצעת המחיר.
finalUrl

string

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

string

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

CallToActionAsset

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

ייצוג JSON 
{
  "callToAction": enum (CallToActionType)
}
שדות
callToAction

enum (CallToActionType)

קריאה לפעולה.

DynamicRealEstateAsset

נכס נדל"ן דינמי.

ייצוג JSON 
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
שדות
listingId

string

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

string

חובה. שם הנכס, לדוגמה, Boulevard Bungalow. חובה.
cityName

string

שם העיר, לדוגמה, תל אביב, ישראל.
description

string

תיאור, לדוגמה, 3 מיטות, 2 חדרי רחצה, 35 מ"ר
address

string

כתובת שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה: 41.40338, 2.17403
price

string

מחיר שאפשר לרוץ ואחריו קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 200,000.00 USD.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
propertyType

string

סוג הנכס, לדוגמה, 'בית'.
listingType

string

סוג כרטיס המוצר, למשל 'למכירה'.
contextualKeywords[]

string

מילות מפתח לפי הקשר, למשל, 'למכירה'; 'בתים למכירה'.
formattedPrice

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם המאפיין הזה מוגדר, הוא ישתמש במאפיין הזה במקום במאפיין 'מחיר', לדוגמה, החל מ-800,000.00 ש"ח.
iosAppStoreId

string (int64 format)

מזהה בחנות האפליקציות ל-iOS. משמש כדי לבדוק אם המשתמש התקין את האפליקציה במכשיר לפני ההפניה של קישורי העומק. אם השדה הזה מוגדר, גם השדה iosAppLink חייב להופיע.
similarListingIds[]

string

מזהי רישומים דומים.

DynamicCustomAsset

נכס דינמי בהתאמה אישית.

ייצוג JSON 
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
שדות
id

string

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

string

מזהה 2, שיכול להיות כל רצף של אותיות וספרות, למשל אדום. רצף מזהים (מזהה + ID2) חייב להיות ייחודי.
itemTitle

string

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

string

כותרת משנה של פריט, לדוגמה: בסוכנות שלכם במאונטיין ויו.
itemDescription

string

תיאור הפריט, למשל 'המכונית הנמכרת ביותר'.
itemAddress

string

כתובת פריט שאפשר לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה: 41.40338, 2.17403
itemCategory

string

קטגוריית הפריט, לדוגמה: מכוניות משפחתיות.
price

string

מחיר שאפשר לרוץ ואחריו קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 20,000.00 USD.
salePrice

string

מחיר מבצע, שאפשר להוסיף אחריו את קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני, לדוגמה: 15,000.00 USD. חייב להיות קטן מהשדה 'מחיר'.
formattedPrice

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם המאפיין הזה מוגדר, הוא ישתמש במאפיין הזה במקום במאפיין 'מחיר', לדוגמה, החל מ-80,000.00 ש"ח.
formattedSalePrice

string

מחיר מבצע בפורמט שהוגדר יכול להיות כל תו. אם המאפיין הזה מוגדר, הוא ישתמש במאפיין הזה במקום במאפיין 'מחיר מבצע', לדוגמה: 'מחיר מבצע בסך 60,000.00 ש"ח'.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
contextualKeywords[]

string

מילות מפתח לפי הקשר, למשל, סדאן, 4 דלתות משפחתיות.
iosAppStoreId

string (int64 format)

מזהה בחנות האפליקציות ל-iOS. משמש כדי לבדוק אם המשתמש התקין את האפליקציה במכשיר לפני ההפניה של קישורי העומק. אם השדה הזה מוגדר, גם השדה iosAppLink חייב להופיע.
similarIds[]

string

מזהים דומים.

DynamicHotelsAndRentalsAsset

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

ייצוג JSON 
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
שדות
propertyId

string

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

string

חובה. שם הנכס, לדוגמה, 'מלון תל אביב'. חובה.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
destinationName

string

שם יעד, לדוגמה, מרכז העיר תל אביב.
description

string

תיאור. לדוגמה, 'קרוב לנמל התעופה של סן פרנסיסקו'.
price

string

מחיר שאפשר לרוץ ואחריו קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 100.00 USD.
salePrice

string

תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה, 80.00 USD. חייב להיות קטן מהשדה 'מחיר'.
starRating

string (int64 format)

דירוג כוכבים. חייב להיות מספר בין 1 ל-5, כולל.
category

string

קטגוריה, לדוגמה, סוויטה במלון.
contextualKeywords[]

string

מילות מפתח לפי הקשר, לדוגמה, "מלונות" במאונטיין ויו, מלונות באילת.
address

string

כתובת שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה: 41.40338, 2.17403
iosAppStoreId

string (int64 format)

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

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם מגדירים את המאפיין הזה, המערכת תשתמש במאפיין הזה במקום במאפיין 'מחיר'. לדוגמה, החל מ-400 ש"ח.
formattedSalePrice

string

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

string

מזהי נכסים דומים.

DynamicFlightsAsset

נכס טיסות דינמי.

ייצוג JSON 
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
שדות
destinationId

string

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

string

מזהה מקור שיכול להיות כל רצף של אותיות וספרות. רצף המזהים (מזהה היעד + מזהה המקור) חייב להיות ייחודי.
flightDescription

string

חובה. תיאור טיסה, למשל, 'הזמנת כרטיס'. חובה.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
destinationName

string

שם היעד, לדוגמה: פריז.
originName

string

שם נקודת המוצא, לדוגמה: לונדון.
flightPrice

string

מחיר הטיסה שאפשר להוסיף אחריו קוד מטבע אלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 100.00 USD.
flightSalePrice

string

מחיר המבצע של הטיסה, שאפשר להזין אחריו מספר ואחריו קוד מטבע אלפביתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה, 80.00 USD. חייב להיות קטן מהשדה 'flightPrice'.
formattedPrice

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם מגדירים את המאפיין הזה, המערכת תשתמש במאפיין הזה במקום במאפיין 'מחיר'. לדוגמה, החל מ-400 ש"ח.
formattedSalePrice

string

מחיר מבצע בפורמט שהוגדר יכול להיות כל תו. אם המאפיין הזה מוגדר, הוא ישתמש במאפיין הזה במקום במאפיין 'מחיר מבצע', לדוגמה: 'מחיר מבצע בסך 80.00$'.
iosAppStoreId

string (int64 format)

מזהה בחנות האפליקציות ל-iOS. משמש כדי לבדוק אם המשתמש התקין את האפליקציה במכשיר לפני ההפניה של קישורי העומק. אם השדה הזה מוגדר, גם השדה iosAppLink חייב להופיע.
similarDestinationIds[]

string

מזהי יעדים דומים, למשל PAR,LON.
customMapping

string

שדה מותאם אישית שיכול להיות כמה מפתחות למיפוי ערכים שמופרדים באמצעות תווי הפרדה (",", "|" ו-":"), בצורות ": , , ... , | : , ... , | ... | : , ... ,", לדוגמה, Wi-Fi: רוב | המטוסים: 320, 77W | flights: 42 | {/1.1

DiscoveryCarouselCardAsset

נכס בכרטיס קרוסלה Discovery.

ייצוג JSON 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
שדות
marketingImageAsset

string

שם משאב הנכס של התמונה השיווקית המשויכת ביחס של 1.91:1. חובה להוסיף את הנכס הזה או נכס של תמונה שיווקית ריבועית.
squareMarketingImageAsset

string

שם המשאב של הנכס של התמונה השיווקית המרובעת המשויכת. השדה הזה ו/או נכס של תמונה שיווקית הוא חובה.
portraitMarketingImageAsset

string

השם של משאב הנכס של התמונה השיווקית המשויכת לאורך 4:5.
headline

string

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

string

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

DynamicTravelAsset

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

ייצוג JSON 
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
שדות
destinationId

string

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

string

מזהה מקור שיכול להיות כל רצף של אותיות וספרות. רצף המזהים (מזהה היעד + מזהה המקור) חייב להיות ייחודי.
title

string

חובה. שם, לדוגמה, 'הזמנת כרטיס הרכבת'. חובה.
destinationName

string

שם היעד, לדוגמה: פריז.
destinationAddress

string

כתובת יעד שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה, 41.40338, 2.17403.
originName

string

שם נקודת המוצא, לדוגמה: לונדון.
price

string

המחיר יכול להיות מספר ואחריו קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 100.00 USD.
salePrice

string

מחיר מבצע, שיכול להיות מספר ואחריו קוד מטבע אלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה, 80.00 USD. חייב להיות קטן מהשדה 'מחיר'.
formattedPrice

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם מגדירים את המאפיין הזה, המערכת תשתמש במאפיין הזה במקום במאפיין 'מחיר'. לדוגמה, החל מ-400 ש"ח.
formattedSalePrice

string

מחיר מבצע בפורמט שהוגדר יכול להיות כל תו. אם המאפיין הזה מוגדר, הוא ישתמש במאפיין הזה במקום במאפיין 'מחיר מבצע', לדוגמה: 'מחיר מבצע בסך 80.00$'.
category

string

קטגוריה, למשל Express.
contextualKeywords[]

string

מילות מפתח לפי הקשר, לדוגמה, רכבות בפריז.
similarDestinationIds[]

string

מזהי יעדים דומים, לדוגמה: NYC.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
iosAppStoreId

string (int64 format)

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

DynamicLocalAsset

נכס מקומי דינמי.

ייצוג JSON 
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
שדות
dealId

string

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

string

חובה. שם המבצע, לדוגמה, 50% הנחה בצרכני Mountain View. חובה.
subtitle

string

כתובית, לדוגמה, "מוצרי מכולת".
description

string

תיאור, למשל 'חיסכון בחיוב השבועי'.
price

string

המחיר יכול להיות מספר ואחריו קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה: 100.00 USD.
salePrice

string

מחיר מבצע, שאפשר להוסיף אחריו את קוד המטבע האלפאבתי, לפי תקן ISO 4217. צריך להשתמש ב-'.' בתור הסימן העשרוני. לדוגמה, 80.00 USD. חייב להיות קטן מהשדה 'מחיר'.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
address

string

כתובת שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה, 41.40338, 2.17403.
category

string

קטגוריה, לדוגמה, אוכל.
contextualKeywords[]

string

מילות מפתח לפי הקשר, לדוגמה, "שמירת שוברים לקניית מצרכים".
formattedPrice

string

מחיר בפורמט שהוגדר יכול להיות כל תו. אם מגדירים את המאפיין הזה, המערכת תשתמש במאפיין הזה במקום במאפיין 'מחיר'. לדוגמה, החל מ-400 ש"ח.
formattedSalePrice

string

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

string

מזהי עסקאות דומים, לדוגמה, 1275.
iosAppStoreId

string (int64 format)

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

DynamicJobsAsset

נכס משרות דינמי.

ייצוג JSON 
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
שדות
jobId

string

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

string

מזהה מיקום, שיכול להיות כל רצף של אותיות וספרות. רצף המזהים (מזהה משימה + מזהה מיקום) חייב להיות ייחודי.
jobTitle

string

חובה. תפקיד, למשל: מהנדסי תוכנה. חובה.
jobSubtitle

string

כותרת משנה של משימה, לדוגמה, רמה 2.
description

string

תיאור, לדוגמה: 'יישמו את הכישורים הטכניים'.
imageUrl

string

כתובת URL של תמונה, לדוגמה: http://www.example.com/image.png. התמונה לא תועלה כנכס תמונות.
jobCategory

string

קטגוריית התפקיד, למשל 'טכני'.
contextualKeywords[]

string

מילות מפתח לפי הקשר, לדוגמה, משרה בהנדסת תוכנה.
address

string

כתובת שניתן לציין באחד מהפורמטים הבאים. (1) עיר, מדינה (State), קוד, מדינה, למשל: תל אביב, ישראל, ישראל. (2) כתובת מלאה. לדוגמה, 123 Boulevard St, Mountain View, CA 94043. (3) קווי אורך ורוחב בפורמט DDD, לדוגמה, 41.40338, 2.17403.
salary

string

שכר, לדוגמה: 400,000 ש"ח.
similarJobIds[]

string

מזהי משימות דומים, למשל 1275.
iosAppStoreId

string (int64 format)

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

LocationAsset

נכס מיקום.

ייצוג JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
שדות
placeId

string

מזהי המקומות מזהים מקום באופן ייחודי במסד הנתונים של 'מקומות Google' ובמפות Google. השדה הזה ייחודי לכל מספר לקוח ולסוג נכס. מידע נוסף על מזהה מקום זמין בכתובת https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

סוג הבעלות על המיקום. אם הסוג הוא BUSINESS_OWNER, הוא יוצג כתוסף מיקום. אם הסוג הוא שותף עצמאי, הוא יוצג כמיקום של מפיץ.

BusinessProfileLocation

נתוני המיקום של פרופיל העסק סונכרנו מהחשבון המקושר של 'פרופיל העסק ב-Google'.

ייצוג JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
שדות
labels[]

string

המפרסם ציין את התווית של המיקום בחשבון של פרופיל העסק. הנתונים האלה מסונכרנים מהחשבון ב'פרופיל העסק ב-Google'.
storeCode

string

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

string (int64 format)

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

HotelPropertyAsset

נכס של נכס מלון.

ייצוג JSON 
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
שדות
placeId

string

מזהי המקומות מזהים מקום באופן ייחודי במסד הנתונים של 'מקומות Google' ובמפות Google. מידע נוסף זמין בכתובת https://developers.google.com/places/web-service/place-id.
hotelAddress

string

כתובת המלון. קריאה בלבד.
hotelName

string

שם המלון. קריאה בלבד.